home *** CD-ROM | disk | FTP | other *** search
/ 8bitfiles.net/archives / archives.tar / archives / genie-commodore-file-library / C64Toolkit / DIRECTORY-DESIGNER.SDA / INSTRUCTIONS PT1 < prev    next >
Text File  |  2019-04-13  |  11KB  |  96 lines

  1.          ─┴╓╔─'╙ ─╔╥┼├╘╧╥┘ ─┼╙╔╟╬┼╥
  2.  
  3. ╫ELCOME TO ─┴╓╔─'╙ ─╔╥┼├╘╧╥┘ ─┼╙╔╟╬┼╥ - A PROGRAM WHICH ALLOWS YOU TO REORGANIZE AND REDESIGN A DISK'S DIRECTORY IN ALMOST ANY WAY YOU WANT.
  4.  
  5. ╔F YOU ARE READING THIS FILE ON THE SCREEN THEN IT CAN BE PAUSED AT ANY TIME, AND LATER CONTINUED, BY PRESSING THE ╙╨┴├┼ ┬┴╥.  ╥EADING THIS FILE CAN BE ABORTED AT ANY TIME BY PRESSING THE ╥┼╘╒╥╬ KEY.  ╧NCE ABORTED, IT CAN ALSO BE REREAD FROM WITHIN THE MAIN PROGRAM BY USING THE ╪-╥┴┘ OPTION.
  6.  
  7. ╫HAT YOU ARE READING IS A STANDARD SEQUENTIAL FILE WHICH CAN BE PRINTED USING ┼ASYSCRIPT, ╨APERCLIP, OR ANY OTHER WORD PROCESSOR OR FILE READER WHICH PROCESSES SEQUENTIAL FILES.  ├ONSEQUENTLY, IF YOU WANT A HARD COPY OF THESE INSTRUCTIONS, LOAD THE FILES CALLED ╔╬╙╘╥╒├╘╔╧╬╙ ╨╘1 AND ╔╬╙╘╥╒├╘╔╧╬╙ ╨╘2 INTO YOUR WORD PROCESSOR, EDIT THEM AS YOU PLEASE, AND DUMP THEM TO PRINTER.  ╘HE FILE ╔╬╙╘╥╒├╘╔╧╬╙ IS FORMATTED FOR THE SCREEN (40 COLUMNS WIDE), WHILE ╔╬╙╘╥╒├╘╔╧╬╙ ╨╘1 & ╨╘2 IS THE SAME FILE (SPLIT INTO TWO) IN STANDARD WORD-PROCESSOR FORMAT, I.E. CARRIAGE RETURNS ARE USED TO SEPARATE PARAGRAPHS, NOT TO SEPARATE LINES.
  8.  
  9. ╘HIS PROGRAM HAS MANY FEATURES THAT COMPLEMENT EACH OTHER, SOME OF WHICH ARE:
  10.  
  11. (1) ╘HE ABILITY TO EDIT THE DIRECTORY OF ANY UNPROTECTED DISK, AND REARRANGE AND INSERT DESIGNS, SUCH AS "****************", OR "*─┴╓╔─ ╠╧╓┼╠╧├╦*", SO THAT A DIRECTORY MIGHT START LIKE THIS:
  12.  
  13.   0 "****************"   ╒╙╥
  14.   0 "*              *"   ╒╙╥
  15.   0 "*─┴╓╔─ ╠╧╓┼╠╧├╦*"   ╒╙╥
  16.   0 "*              *"   ╒╙╥
  17.   0 "****************"   ╒╙╥
  18.   0 "                "   ╒╙╥
  19.  96 "─┴╓╔─'╙ ─┼╙╔╟╬┼╥"   ╨╥╟
  20.   0 "                "   ╒╙╥
  21.   0 "****************"   ╒╙╥
  22.  
  23. (2) ╘HE ABILITY TO READ STANDARD ╙┼╤ FILES AND REGULAR ┬┴╙╔├ PROGRAMS FROM WITHIN ITSELF.  ╔F A ╨╥╟ IS NOT A REGULAR ┬┴╙╔├ ╨╥╟ (I.E. DOES NOT LOAD IN AT 2049), THE LOAD ADDRESS OF THAT ╨╥╟ IS SHOWN IN DECIMAL.  ╘HIS PERMITS YOU TO GO THROUGH YOUR DISKS, LOOK AT THE FILES, AND DECIDE WHICH ONES TO DELETE IN ORDER TO PURGE AND REORGANIZE YOUR DIRECTORY.
  24.  
  25. (3) ╘HE ABILITY TO READ, EDIT, AND WRITE TO, ANY TRACK AND SECTOR ON DISK, WHICH THEREFORE GIVES YOU DIRECT USER ACCESS TO THE DISK FROM WITHIN THIS PROGRAM.
  26.  
  27. (4) ╘HE ABILITY TO PRINT THE DIRECTORY IN A FORMAT WHICH CAN BE STORED IN THE DISK-JACKET.
  28.  
  29. (5) ╘HE ABILITY TO PROTECT ANY FILE FROM BEING SCRATCHED.
  30.  
  31. ╘HIS PROGRAM IS DESIGNED TO RUN ON A ├OMMODORE 64 WITH A SINGLE 1541 DISK DRIVE.  ╔T ALSO RUNS ON THE SINGLE AND DOUBLE ═╙─ DRIVES IN BOTH SERIAL AND PARALLEL MODE, IF THE INTERFACE IS TRANSPARENT, (LIKE THE ┬US├ARD ╔╔).  ╘HE PRINT ROUTINES ARE OPTIONAL AND ARE WRITTEN WITH A STANDARD ├OMMODORE PRINTER IN MIND, OR A NON-├OMMODORE PRINTER, SUCH AS THE ╧KIDATA 92 WITH AN INTERFACE THAT CAN EMULATE A ├OMMODORE PRINTER.  ╔F YOU ARE USING A PRINTER, YOU SHOULD TURN IT ON BEFORE RUNNING THE PROGRAM.  ╘HERE ARE MANY INSTANCES OF THE ├OMMODORE 64 BEING RESET BY TURNING DISK DRIVES OR PRINTERS ON AND OFF.
  32.  
  33. ╫HEN YOU FINISH READING THIS FILE, YOU WILL BE TOLD TO PUT THE DISK WITH THE DIRECTORY (ABBREVIATED "$" IN ALL THE COMMANDS) WHICH NEEDS EDITING IN THE DRIVE.  ╔F THE DIRECTORY IS CIRCULAR, I.E. READS CONTINUOUSLY WITHOUT END, YOU ARE SO ADVISED AND THE LOAD IS ABORTED.  ╔F THE DISK IS SOFTWARE WRITE-PROTECTED (SUCH AS ┼┴╙┘╙├╥╔╨╘, AND THIS DISK) YOU WILL ALSO BE ADVISED BUT THE LOAD IS NOT ABORTED.  ╘HIS IS AN EXAMPLE OF A PROTECTED DISK THAT THIS PROGRAM WILL NOT ATTEMPT TO WRITE TO.  (╔T IS POSSIBLE TO EDIT SUCH DISKS, BUT IN THE HANDS OF A CARELESS USER THIS COULD BE DANGEROUS, SO ╔ CHOSE NOT TO ALLOW SUCH DISKS TO BE EDITED WITH THIS PROGRAM.)
  34.  
  35. ╒NTIL YOU HAVE USED THIS PROGRAM A FEW TIMES ╔ ╙╘╥╧╬╟╠┘ ╒╥╟┼ ┘╧╒ ╘╧ ╘╥┘ ╔╘ ╧╒╘ ╧╬ ┬┴├╦╒╨ ─╔╙╦╙, INSTEAD OF ORIGINALS.  ╔N THIS WAY YOU CAN AFFORD TO MAKE MISTAKES WITHOUT DISASTROUS CONSEQUENCES.
  36.  
  37. ┴FTER THE DIRECTORY HAS BEEN READ, THE  FIRST ╨┴╟┼ OF 20 FILENAMES IS DISPLAYED, IN THE STANDARD ╒PPERCASE/╟RAPHICS MODE, IN A BOX ON THE LEFT-HAND SIDE OF THE SCREEN.  ╘HE FIVE CHARACTERS WHICH CAN CAUSE THE MOST TROUBLE WHEN LISTING A DIRECTORY (├ARRIAGE ╥ETURN, ╤UOTES, ─ELETE, ╙HIFTED ╥ETURN, AND ├╚╥$(0)) ARE INTERCEPTED BEFORE THEY ARE DISPLAYED AND ARE REPLACED BY ?, EXCEPT THE QUOTE WHICH IS REPLACED BY '.  (╔F YOU USE THE ╥┼╬┴═┼ COMMAND ON A FILENAME CONTAINING ONE OF THESE CHARACTERS, THE CORRECT SYMBOL IS REPRESENTED BETWEEN AN EXTRA SET OF QUOTES).
  38.  
  39. ┬ELOW THIS BOX OF FILENAMES IS DISPLAYED THE TOTAL NUMBER OF ENTRIES IN THE DIRECTORY.
  40.  
  41. ╧N THE RIGHT-HAND SIDE OF THE BOX CONTAINING THE FILENAMES, IS A LIST OF 23 ├╧══┴╬─╙ FROM WHICH TO CHOOSE.  ┴ FLASHING CURSOR APPEARS OVER ╨┴╟┼.  ╘HERE ARE TWO WAYS TO SELECT A ├╧══┴╬─.
  42. (1) ═OVE THE CURSOR WITH THE CURSOR-UP AND CURSOR-DOWN KEYS AND THEN PRESS THE ╥┼╘╒╥╬ KEY.  ╘HIS WILL SELECT THE COMMAND UNDER THE CURSOR.
  43. (2) ╨RESS THE FIRST LETTER OF ANY COMMAND.  ╘HIS WILL SELECT THAT COMMAND (WITH THE EXCEPTION OF ╨, WHICH ALWAYS SELECTS ╨┴├╦, NOT ╨┴╟┼).
  44.  
  45. ┴FTER A ├╧══┴╬─ HAS BEEN SELECTED, ANSWER ANY QUESTIONS WHICH ARE PRINTED AT THE BOTTOM OF THE SCREEN.  ╔F YOU SELECT A ├╧══┴╬─ THAT YOU DON'T WANT, AND AN ANSWER IS REQUIRED, PRESSING ╥┼╘╒╥╬ WILL ABORT THE ├╧══┴╬─ AND RETURN YOU TO THE MAIN DISPLAY.  ╘HE MAXIMUM NUMBER OF CHARACTERS EXPECTED IN A RESPONSE IS INDICATED BY THE NUMBER OF DOTS.  ╧NLY THE DELETE KEY CAN BE USED TO CORRECT YOUR RESPONSE.  ╘HE "╞1" KEY, ON THE RIGHT-HAND SIDE OF THE KEYBOARD, CAN BE USED TO ERASE THE ENTIRE ENTRY.
  46.  
  47. ╒NTIL THE DIRECTORY IS RESAVED, (USING  THE ╫╥╔╘┼ $ COMMAND), ┴╠╠ ═┴╬╔╨╒╠┴╘╔╧╬╙ ┴╥┼ ─╧╬┼ ╔╬ ═┼═╧╥┘ ┴╬─ ╬╧╘╚╔╬╟ ╔╙ ╙┴╓┼─ ╘╧ ╘╚┼ ─╔╥┼├╘╧╥┘ ╧╬ ─╔╙╦.  (╘HERE IS ONE EXCEPTION TO THIS, SEE ╒NDISPLAYED ├OMMANDS BELOW).  ╔F YOU DON'T LIKE THE DIRECTORY YOU CREATE, DON'T SAVE IT!  ╘O SEE THE DIRECTORY IN ╠OWER/╒PPER CASE MODE, JUST PRESS THE ╙HIFT AND ├OMMODORE KEYS SIMULTANEOUSLY.
  48.  
  49. ╘HE AVAILABLE ├╧══┴╬─╙, IN THE ORDER THEY APPEAR ON THE RIGHT-HAND SIDE OF THE SCREEN, ARE :
  50.  
  51.         ╨┴╟┼
  52.         ┴── ╘╧         ╠╧┴─ $
  53.         ┬┴╙╔├          ═╧╓┼
  54.         ├┼╬╘┼╥         ╧╧╨╙
  55.         ─╒═╨ $         ╨┴├╦
  56.         ┼├╚╧           ╤╒┼╥┘
  57.         ╞╔╬─           ╥┼╬┴═┼
  58.         ╟╒┴╥─          ╙╧╥╘
  59.         ╚╒┼            ╘╥┴─┼
  60.         ╔╬╙┼╥╘         ╓╔┼╫ $
  61.         ╩╒═╨ ╘╧        ╫╥╔╘┼ $
  62.         ╦╔╠╠           ╪-╥┴┘
  63.  
  64. ┼ACH OF THESE IS NOW DISCUSSED IN TURN.
  65.  
  66.       ╨┴╟┼
  67. ╔F THERE ARE MORE THAN 20 FILENAMES THEN ╨┴╟┼ WILL DISPLAY THE NEXT 20 FILENAMES IN THE BOX, AND SO ON.  ╨RESSING ╨┴╟┼ ON THE LAST PAGE WILL TAKE YOU BACK TO THE FIRST 20 NAMES.  ╨AGE ALWAYS GOES FORWARD.  ╔F YOU WANT TO MOVE ANYWHERE ELSE, USE THE ╞╔╬─ OR ╩╒═╨ ╘╧ COMMAND.
  68.  
  69.       ┴── ╘╧
  70. ╘HIS ALLOWS YOU TO ADD AN EXTENSION TO A FILENAME, IF THE FILENAME IS NOT TOO LONG.  ┴N EXTENSION IS SOMETHING WHICH APPEARS OUTSIDE THE QUOTES WHEN YOU LIST A ─IRECTORY.  ┼XAMPLES OF THIS ARE ",8:"AND "╙┘╙49152".  ╫HEN THIS OPTION IS CHOSEN YOU CAN SELECT FROM YOUR OWN DESIGN, OR FROM A LIBRARY, IN A MANNER SIMILAR TO ╔╬╙┼╥╘.  ┴── ╘╧ CAN ALSO BE USED TO ╥┼═╧╓┼ AN EXTENSION FROM A FILENAME, BY FOLLOWING THE INSTRUCTIONS ON THE SCREEN.
  71.  
  72.       ┬┴╙╔├
  73. ╘HIS RETURNS YOU TO ┬┴╙╔├, AND THE DIRECTORY IN MEMORY IS LOST.  ╔F YOU HAVE AN EDITED DIRECTORY YOU WANT TO SAVE, USE ╫╥╔╘┼ $ BEFORE USING ┬┴╙╔├.  ┘OU CANNOT RERUN THE PROGRAM AFTER EXITING.
  74.  
  75.       ├┼╬╘┼╥
  76. ╘HIS CENTERS ANY FILENAME.  ╘HIS ALSO HAS THE OPTION OF ADDING A BORDER DESIGN TO A FILENAME AS IT IS CENTERED.  ╔F YOU USE THIS COMMAND ON ANYTHING BUT A DESIGN, YOU MUST REMEMBER THAT THE PRE-CENTERED FILENAME HAS ESSENTIALLY BEEN RENAMED, IF YOU TRY TO LOAD AND RUN IT IN THE CONVENTIONAL WAY.
  77.  
  78.       ─╒═╨ $
  79. ╘HIS PRINTS THE DIRECTORY TO A ├OMMODORE PRINTER, OR ONE WHICH EMULATES A ├OMMODORE.  ╘HE DIRECTORY IS PRINTED WITH A TITLE BOX WHICH CONTAINS THE DISK HEADER, ╔─, AND NUMBER OF BLOCKS FREE.  ╘HERE IS ALSO PROVISION FOR A MESSAGE OF UP TO 30 CHARACTERS TO BE PRINTED IN THIS BOX.  ╙UGGESTED USES FOR THIS MESSAGE ARE DATES, COMMENTS ABOUT THE DISK CONTENTS, ORIGIN OF DISK, OR A MESSAGE ON LOADING THE DISK.  (╔F YOU DON'T WANT TO PRINT A MESSAGE THEN ╨╥┼╙╙ ╘╚┼ ╙╨┴├┼-┬┴╥ BEFORE PRESSING ╥┼╘╒╥╬.  ╨RESSING ╥┼╘╒╥╬ BY ITSELF WILL ABORT THE COMMAND.)  ┘OU ARE GIVEN THE OPTION OF PRINTING IN NORMAL PRINT (╒PPER/╟RAPHICS CASE) OR ╠OWER/╒PPER CASE.  ╔F YOU SELECT ╠OWER/╒PPER THE SCREEN DISPLAY WITHIN THE BOX IS CHANGED TO REFLECT THIS, AND YOU ARE ASKED TO CONFIRM YOUR CHOICE.  ┴LL CHARACTERS WHICH CAUSE THE PRINTER PROBLEMS ARE INTERCEPTED AND REPLACED BY A "?".  ╘HE QUOTE IS REPLACED BY '.  ╘HE PRINTOUT IS THE CORRECT WIDTH TO FIT INTO THE SLEEVE OF A DISK, SHOULD YOU WISH TO CUT IT OUT AND USE IT THAT WAY.  ╘HE DISK CONTENTS ARE PRINTED TWO ABREAST.  ╒NLESS YOU USE ╨┴├╦, ALL ─┼╠ETED FILES ARE ALSO DISPLAYED IN THEIR CORRECT POSITION.
  80.  
  81.       ┼├╚╧
  82. ╘HIS DUPLICATES AN EXISTING ─┼╙╔╟╬ (A ╒╙╥ FILENAME OF LENGTH ZERO) FROM ONE LOCATION TO ANOTHER.  ╔T WILL ╬╧╘ ALLOW YOU TO DUPLICATE A "GENUINE" FILENAME.
  83.  
  84.       ╞╔╬─
  85. ╙ELECTING THIS COMMAND WILL ALLOW YOU TO FIND THE FIRST MATCHING FILENAME (OR PART OF THE FILENAME) FROM THE TOP OF THE PRESENT ╨┴╟┼ TO THE END OF THE DIRECTORY.  ╔F A MATCH IS FOUND, THE PAGE ON WHICH IT FIRST OCCURS IS DISPLAYED.  ╘HERE IS THE CHOICE OF A QUICK-FIND, WHICH ONLY SEARCHES THE BEGINNING OF EACH FILENAME FOR A MATCH, AND A SLOW-FIND, WHICH SEARCHES THROUGH THE ENTIRE FILENAME LOOKING FOR A MATCH.  ┴ SLOW-FIND FOR "┬╥" WOULD FIND EITHER "┬╥╔╠╠╔┴╬╘ ╨╥╟" OR "┴ ┬╥╔╠╠╔┴╬╘ ╨╥╟", WHICHEVER OCCURS FIRST.  ┴ FAST-FIND WOULD ONLY FIND "┬╥╔╠╠╔┴╬╘ ╨╥╟".
  86.  
  87.       ╟╒┴╥─
  88. ╔T IS POSSIBLE TO SOFTWARE PROTECT INDIVIDUAL FILES, AND THIS IS INDICATED BY THE SYMBOL "<" BEING PLACED TO THE RIGHT OF THE PROGRAM TYPE, SUCH AS "╨╥╟<".  ╘HIS COMMAND ALLOWS YOU TO PROTECT/GUARD (OR UNPROTECT/UNGUARD) EITHER ALL THE FILES OR ANY ONE YOU CHOOSE.  ╘HIS COMMAND WILL NOT ALLOW YOU TO GUARD ─┼╠ETED FILES OR FILES THAT YOU HAVE ╦╔╠╠ED.
  89.  
  90.       ╚╒┼
  91. ╘HIS CONTAINS ITS OWN INSTRUCTIONS, AND PERMITS YOU TO CHANGE THE COLOR OF THE CURSOR, THE BORDER, AND THE BACKGROUND, TO SUIT YOUR TASTE (OR LACK OF IT!).  ╨RESSING THE ├╘╥╠ KEY WITH ANY OF THE DESCRIBED KEY COMBINATIONS GIVES YOU ACCESS TO THE SECOND SET OF 8 COLORS.
  92.  
  93.       ╔╬╙┼╥╘
  94. ╘HIS ALLOWS YOU TO INSERT A DESIGN IN THE DIRECTORY.  ┼ACH FILE ╔╬╙┼╥╘ED IN THIS WAY CREATES A ╒╙┼╥ (╒╙╥) FILE OF ZERO LENGTH WHICH DOES NOT REQUIRE ANY DISK SPACE.  ╚OWEVER, A MAXIMUM OF 144 FILENAMES IS PERMITTED BY THE ├OMMODORE 1541 ─╧╙, SO THE PENALTY FOR ╔╬╙┼╥╘ING A FILENAME IN THIS WAY IS THE LOSS OF ONE GENUINE FILENAME, NOT THE LOSS OF DISK SPACE.  ╫HEN THIS OPTION IS SELECTED YOU ARE ASKED WHETHER YOU WANT TO DESIGN YOUR OWN FILENAME (SELECT ╧) OR TO USE ONE OF THE 20 DESIGNS IN THE LIBRARY (SELECT ╠).  ╔F YOU SELECT ╧ THEN YOU CAN CREATE A DESIGN OF UP TO 16 CHARACTERS USING ANY OF THE ├OMMODORE KEYS, EXCEPT THOSE THAT AFFECT SCREEN EDITING, LIKE ╚╧═┼, ├╥╙╥, ─┼╠┼╘┼, ╤╒╧╘┼╙ ETC..  ╞ILENAMES OF TYPE ╒╙╥ AND LENGTH ZERO ARE CALLED ─┼╙╔╟╬S.
  95.  
  96.